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Web Service Software Development Kit Overview 
This software development kit (SDK) is intended to provide software and Internet developers with the 
ability to integrate postage rate information into programs and/or web sites. 


Licenses and Liability 

The information and components contained within this SDK may be distributed only to individuals who 
have signed the USPS User License and may only be used in accordance with the terms of the USPS User 
License. The USPS assumes no liability for the incorrect implementation of this SDK once it has been 
incorporated into a client product. The USPS will supply upgrades to the data and/or the objects when 


needed, but it assumes no part in distribution of these upgrades once the engine has been integrated 
into client products. 


Purpose 
This document will explain the Domestic and International Pricing EngineWC3 Web Service Interface. 


Contact Information 


For Technical Support, contact: 
Email: RCalcPEPMOSupport @ usps. gov 


For USPS Support, contact USPS: 
Email: PostalExplorer(9 usps.com 
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Application Programming Interface (API) 


Overview 

The Pricing Engine is built using the Model, View, Controller (MVC) design pattern and should be used as 
a black box. All of the Pricing Engine behavior is provide by making calls to methods that are part of a 
two interface classes named PostOfficeServices and PricingServices. 


Working IDs 

The Pricing Engine does not enumerate the ID. This was done to allow for greater flexibility. As new 
services are added the ID of that service only needs to be known to the service itself. The user of the 
Pricing Engine should not hard code any IDsinto their application because services and IDs may change 
over time. To getthe ID of a service, the developer should request the services by specifying to know 
mail properties and then use the ID of the desired service from the results returned. 


Domestic Pricing Engine Interface 


The following operations are defined for the Domestic Pricing Engine. See "Pricing Engine Design 
Model. pdf" for details. 


PostOfficeServices Class 
GetLocations Method 


Description 
This method is used to get locations by specifying a list of ZIP Codes. The similiar method with the 
forDate input parameter changesthe behavior to produce results available as of the date specified. 


Syntax 
GetLocations(in zipCodes : ZipCode[]) : Location[] 


GetLocations(in zipCodes : ZipCodeCollection, in forDate : DateTime): Location[] 
GetMailingRestrictions Method 


Description 

This method is used to get the mailing restrictions for a specified ZIP Code or collection of ZIP Codes. The 
similiar method with the forDate input parameter changesthe behavior to produce results available as 
of the date specified. 


Syntax 
GetMailingRestrictions(in zipCodes : ZipCode[]) : MailingRestriction[] 


GetMailingRestrictions(in zipcodes : ZipCodeCollection, in forDate : DateTime): MailingRestriction[] 
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GetZone Method 


Description 
The method is used to get the zone information between origination and destination ZIP codes. The 


similiar method with the forDate input parameter changesthe behavior to produce results available as 
of the date specified. 


Syntax 
GetZone(in originZIPCode : ZipCode, in destinationZIPCode: ZipCode) : Zone 


GetZone(in originZIPCode : ZipCode, in destinationZIPCode: ZipCode, in forDate : DateTime): Zone 
GetZones Method 


Description 

The method is used toget the zone information for a 3-digit ZIP Code. When the ZIP Code collection 
contains more than a single 3-digit ZIP Code, zone information is returned to each ZIP Code passed. The 
similiar method with the forDate input parameter changesthe behavior to produce results available as 
of the date specified. 


Syntax 
GetZones(in zipCodes : ZipCode[]) : Zone[] 


GetZones(in zipCodes : ZipCodeCollection, in forDate : DateTime) : Zone[] 


PricingServices Class 


CalculateServicePrice Method 


Description 
This method is used to calculate the total cost of a selected mail service and any selected extra services. 


Syntax 
CalculateServicePrice(in request : WSCalculationRequest) : CalculatedPricing 


GetExtraServicesWithPricing Method 


Description 
This method is used to get a specified list of extra service with the price of each. 


Syntax 


GetExtraServicesWithPricing(in extraServicesRequest: WSExtraServicesRequest) : 
ExtraServicesWithPricing 
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GetServiceCommitments Method 


Description 
This method is used to get the mailing service commitments for the specified request. The caller is 
required to specify the following: 

e Origin ZIP Code 

e Destination ZIP Code 

e Shipping date/time 

e Mail shape and size 


Syntax 
GetServiceCommitments(in servicesRequest : WSServicesRequest) : ServiceCommitment[] 


GetServiceWithPricing Method 


Description 
This method is used to get a list of mailing services with associated extra services for the specified mail 
piece attributes. 


Syntax 
GetServiceWithPricing(in request : ServiceRequest) : ServiceWithPricing 


GetPriceBySKU Method 


Description 

This method is used to get a collection of Prices for a specified SKU. The requested SKU can be a full 15 
digit SKU or a partial SKU. The requested SKU can also contain wildcard characters "96". The result 
collection will contain all prices that match the requested SKU. Each node in the collection contains the 
SKU, Price, Postage Statement Section and Postage Statement Line. 


Syntax 
GetPriceBySKU(in priceBySKURequest : SKURequest) : SKUPrice[] 


GetMailingFees Method 


Description 
The method is used toget the Mailing Fee for a specified key. 


Syntax 
GetMailingFees(in mailingFeeRequest : MailingFeeRequest) : MailingFee 


Validate Method 


Description 
This method is used to validate the specified mail properties. The method will return origin and 
destination location objects. 
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Syntax 
Validate(in servicesRequest : WSServicesRequest) : Location[] 


WSCalculationRequest Class 


Base Class 
WSServicesRequest 


Properties 
Selections : CalculationSelections 
IsExtraServiceConversational : bool 


CalculatedPricing Class 


Base Class 
None 


Properties 

Geography : Geography 
Commitments : ServiceCommitment[] 
Restrictions : MailingRestriction[] 
Service : PostageService 

Annotations : Annotation[] 

Totals : PostagePrice[] 

Effective: DateTime 


CalculationSelections Class 


Base Class 
None 


Properties 

MailServicelD : MailServicelD 
DeliveryOptionKey : string 
ExtraServices : ExtraServicelD[] 


WSExtraServicesRequest Class 


Base Class 
None 


Properties 
IDCard: IDCard 
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Weight : Weight 

ExcludeSections : ResultSection[] 

MailServicelD : MailServicelD 

ExtraServices: ExtraServicelD[] 
ExtraServiceParameters : AdditionallnputValue[] 
ShippingDateTime : DateTime 


ExtraServicesWithPricing Class 


Base Class 
None 


Properties 

ExtraServices : ExtraPostageService[] 
Annotations : Annotation[] 

Effective: DateTime 


Geography Class 


Base Class 
None 


Properties 
DestinationCity : string 
DestinationState : string 
DestinationlsAPO : bool 
OriginCity : string 
OriginState : string 
OriginIsAPO : bool 

Zone : int 

IsLocal : bool 
CommonNDC : bool 


MailingFee Class 


Base Class 
None 


Properties 

Cost : decimal 

FeeKey : string 

Price : decimal 

ValueKey : string 
ValueKeyLowerLimit : decimal 
ValueKeyUpperLimit : decimal 
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Effective: DateTime 


WSMailingFeeRequest Class 


Base Class 
None 


Properties 

IDCard: IDCard 

FeeKeys : MailingFeeRequest .FeeKey [] 
QueryValue : decimal 
ShippingDateTime: DateTime 


MailingFeeRequest .FeeKey Class 


Base Class 
None 


Properties 
Value : string 


WSMailPieceAttributes Class 


Base Class 
None 


Properties 

Origin : LocationAttributes 

Destination : LocationAttributes 
ShippingDateTime : DateTime 

Dimensions : Dimensions 

Weight : Weight 

MailShapeAndSizes : MailShapeAndSize[] 
MailPieceContents : MailPieceContent[] 
MailEntryPoint : DestinationEntry.EntryValue 
Sortation : string 


DestinationEntry.EntryValue Enumerator 
None 

DNDC 

DSCF 

DDU 

DFSS 
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MailPieceAttributes.LocationAttributes Class 


Base Class 
None 


Properties 
ZIP: ZipCode 
IsPOBox : bool 


MailPieceContent Class 


Base Class 
None 


Properties 
Key : string 


WSServicesRequest Class 


Base Class 
None 


Properties 

IDCard: IDCard 

MailPieceAttributes: WSMailPieceAttributes 
ExcludeSections : ResultSection[] 
ExtraServiceParameters : AdditionallnputValue[] 


ServiceWithPricing Class 


Base Class 
None 


Properties 

Geography : Geography 
Commitments : ServiceCommitment[] 
Restrictions : MailingRestriction[] 
Services : PostageService[] 
Annotations : Annotation[] 

Effective: DateTime 
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WSSKURequest Class 


Base Class 
None 


Properties 

IDCard: IDCard 

SKU : string 
ShippingDateTime : DateTime 


SKUPrice Class 


Base Class 
None 


Properties 

SKU : string 

Price : decimal 
PostageStatementSection : string 
PostageStatementLine : int 
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International Pricing Engine Interface 


The following operations are defined for the International Pricing Engine. See “Pricing Engine Design 
Model. pdf" for details. 


PostOfficeServices Class 
GetCountries Method 


Description 
This method is used to get the collection of countries. 


Syntax 
GetCountries() : Country[] 


GetCountriesForDate Method 


Description 
This method is used to getthe collection of countries as of the "forDate". 


Syntax 
GetCountries(in forDate : DateTime) : Country[] 


GetCountryInformation Method 


Description 
This method is used to get the Country Information for a specific country. This includes the country 


price group, prices and other guideline. 


Syntax 
GetCountrylnformation(in country : Country, in calculatorlD : CalculatorlD) : Countrylnformation 


GetCountryInformationForDate Method 


Description 
This method is used to get the Country Information for a specific country as of the "forDate". This 
includes the country price group, prices and other guideline. 


Syntax 
GetCountryInformationForDate(in country : Country, in shippingDate : DateTime) : CountryInformation 


GetCountryRegulations Method 


Description 
This method is used to get the collection of Regulationsfor a specific country. 


Syntax 
GetCountryRegulations(in country : Country) : CountryRegulation[] 
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GetCountryRegulationsForDate Method 


Description 
This method is used to get the collection of Regulations for a specific country as of the "forDate". 


Syntax 
GetCountryRegulationsForDate(in country : Country, in forDate : Datetime) : CountryRegulation[] 


GetPriceBySKU Method 


Description 
This method is used to get a collection of Prices for a specified SKU. The requested SKU can be a full 15 


digit SKU or a partial SKU. The requested SKU can also contain wildcard characters “%”. The result 
collection will contain all prices that match the requested SKU. Each node in the collection contains the 
SKU, Price, Postage Statement Section and Postage Statement Line. 


Syntax 
GetPriceBySKU(in priceBySKURequest : SKURequest) : SKUPrice[] 


ValidateCountry Method 


Description 
This method is used to discover if a specified country is valid. 


Syntax 
ValidateCountry(in countryID : CountryID) : void 


ValidateCountryForDate Method 


Description 
This method is used to discover if a specified country is valid as of the "forDate". 


Syntax 
ValidateCountryForDate(in countrylD : CountryID, in forDate : DateTime): void 


PricingServices Class 
CalculateServicePrice Method 


Description 
This method is used to calculate the total cost of a selected mail service and any selected extra services. 


Syntax 
CalculateServicePrice(in request : WSCalculationRequest) : CalculatedPricing 
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GetExtraServicesWithPricing Method 


Description 
This method is used to get a specified list of extra service with the price of each. 


Syntax 
GetExtraServicesWithPricing (in extraServicesRequest : WSExtraServicesRequest) : 
ExtraServicesWithPricing 


GetServicesWithPricing Method 


Description 
This method is used to get a list of mailing services with associated extra services for the specified mail 


piece attributes. 


Syntax 
GetServicesWithPricing(in servicesRequest : WSServicesRequest) : ServicesWithPricing 


GetPriceBySKU Method 


Description 
This method is used to get a collection of Prices for a specified SKU. The requested SKU can be a full 15 


digit SKU or a partial SKU. The requested SKU can also contain wildcard characters "96". The result 
collection will contain all prices that match the requested SKU. Each node in the collection contains the 
SKU, Price, Postage Statement Section and Postage Statement Line. 


Syntax 
GetPriceBySKU(in priceBySKURequest : SKURequest) : SKUPriceCollection 


GetMailingFees Method 


Description 

The method is used toget the Mailing Fee for a specified key. The Mailing Fee Request can contain a list 
of keys or a single key path with dots “.” delimiters. If the full key path is not specified the result will be 
in the form of a tree with the end of each brunch containing the price, cost, value key, and value limits. 
If the QueryValue is specified the results will be filtered using the value limits. If the value key of all the 
result mailing fee matches, the value is applied to calculate the Cost. 


Request Key Example: 
internationalBusinessReply.Card 


or 


internationalBusinessReply 
Card 
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Query Value Example: 
Request: 

QueryValue = 10 

FeeKey = "internationalBusinessReply. Card” 
Results: 

Price = 0.13 

Cost = 1.30 


Syntax 
GetMailingFees(in mailingFeeRequest : MailingFeeRequest) : MailingFee 


Validate Method 


Description 
This method is used to validate the specified mail properties. 


Syntax 
Validate(servicesRequest : WSServicesRequest) : void 


CalculatedPricing Class 


Base Class 
None 


Properties 

Geography : Geography 
Commitments : ServiceCommitment[] 
Service : PostageService 

Annotations : Annotation[] 

Totals : PostagePrice[] 

Regulations: CountryRegulation 
GXGLocations : GXGLocation[] 
Effective: DateTime 


WSCalculationRequest Class 


Base Class 
ServicesRequest 


Properties 


Selections : CalculationSelections 
IsExtraServiceConversational: bool 
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CalculationSelections Class 


Base Class 
None 


Properties 

MailServicelD : MailServicelD 
DeliveryOptionKey : string 
ExtraServices: ExtraServicelD[] 


Geography Class 


Base Class 
None 


Properties 

ID : CountrylD 
Name: string 
Code : string 
Number : string 


WSExtraServicesRequest Class 


Base Class 
None 


Properties 

IDCard: IDCard 

Weight : Weight 

ExcludeSections : ResultSection[] 

MailServicelD : MailServicelD 

ExtraServices : ExtraServicelD[] 
ExtraServiceParameters : AdditionallnputValue[] 
ShippingDateTime : DateTime 


ExtraServicesWithPricing Class 


Base Class 
None 


Properties 

ExtraServices : ExtraPostageService[] 
Annotations : Annotation[] 

Effective: DateTime 
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WSMailingFeeRequest Class 
Base Class 
None 


Properties 

IDCard: IDCard 

FeeKeys : MailingFeesRequest.FeeKeyCollection 
QueryValue : decimal 

ShippingDateTime : DateTime 


MailingFee Class 


Namespace 
ManTech.Usps.RateEngine.Business.Entity 


Base Class 
None 


Properties 

Cost : decimal 

FeeKey : string 

Price : decimal 

ValueKey : string 
ValueKeyLowerLimit : decimal 
ValueKeyUpperLimit : decimal 
Effective : DateTime 


MailingFeeRequest .FeeKey Class 


Namespace 
ManTech.Usps.RateEngine.Business.Entity 


Base Class 
None 


Properties 


Value : string 


WSMailPieceAttributes Class 


Base Class 
None 


Properties 
Origin : LocationAttributes 
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Destination : LocationAttributes 
ShippingDateTime : DateTime 
Dimensions : Dimensions 

Weight : Weight 

MailShapeAndSizes : MailShapeAndSize[] 
MailPieceContents : MailPieceContent [] 


MailPieceAttributes.LocationAttributes Class 


Base Class 
None 


Properties 

CountryID : CountryID 
CountryName : string 
CountryCode : string 
CountryNumber : string 
PostalCode : string 
IsPOBox : bool 


WSServicesRequest Class 


Base Class 
None 


Properties 

IDCard: IDCard 

MailPieceAttributes : WSMailPieceAttributes 
ExcludeSections : ResultSection[] 
ExtraServiceParameters : AdditionallnputValue[] 


ServicesWithPricing Class 


Base Class 
None 


Properties 

Geography: Geography 
Commitments : ServiceCommitment[] 
Services : PostageService[] 
Regulations: CountryRegulation 
GXGLocations : GXGLocation[] 
Annotations : Annotation[] 

Errors : PricingEngineError[] 
Effective: DateTime 
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WSSKURequest Class 


Base Class 
None 


Properties 

IDCard: IDCard 

SKU : string 
ShippingDateTime : DateTime 


SKUPrice Class 


Base Class 
None 


Properties 

SKU : string 

Price : decimal 
PostageStatementSection : string 
PostageStatementLine : int 
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Rate Engine Framework 


AdditionalInputValue 


Base Class 
None 


Properties 
TypelD : string 
EnteredValue : decimal 


Annotation Class 


Base Class 
None 


Properties 
Text : string 
Associations : Association[] 


Country Class 


Base Class 
None 


Properties 

CountryID : CountryID 
Name: string 
NameParts: string[] 
Code : string 
CountryNumber : string 
TypeOf : short 

Status : CountryStatus 
IsDisplayed : bool 
ShowOnlinePrice : bool 
MaxWeight : Weight 
IsParent : bool 

Aka : CountryAlias[] 


Country.Status Enumerator 
Unknown 

Normal 

NoOnlineService 
ServiceSuspended 
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CountryAlias Class 


Base Class 
None 


Properties 
Alias : string 


CountryID Structure 


Base Class 
None 


Properties 
Value : int 


CountryInformationItem Class 


Base Class 
None 


Properties 

CountryToMailService : CountryToMailService 
CountryToExtraServices : CountryToExtraService[] 
Price : decimal 

OnlinePrice : decimal 

CommercialPlusPrice : decimal 


CountryRegulation Class 


Base Class 
None 


Properties 

Country : Country 

Prohibitions : string 
Restrictions : string 
Observations : string 
CustomsForms : string 
ExpressMailRegulations: string 
ExpressMailNote : string 
AdditionalRestrictions : string 
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CountryToMailService Class 


Base Class 
None 


Properties 

ServiceTitle : string 

MailServicelD : MailServicelD 

IsAvailable : bool 

WeightLimit : Weight 

WeightLimitOperator : Weight. WeightOperator 
weightMin: Weight 

WeightMinOperator : Weight. WeightOperator 
InsuranceMax : decimal 

PriceGroups : PriceGroup[] 
EstimatedDeliveryTime : string 
DimensionalRange : DimensionalRange 


CountryToExtraService Class 


Base Class 
None 


Properties 

ServiceTitle : string 
ExtraServicelD : ExtraServicelD 
IsAvailable : bool 

Price : decimal 

OnlinePrice : decimal 


Dimensions Class 


Base Class 
None 


Properties 

Length : Dimension 

Width : Dimension 

Height : Dimension 

Girth : Dimension 

IsRectangular: bool 
RoundDownToQuarterlnch : bool 
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DimensionalRange Class 


Base Class 
None 


Properties 

MaxLength: Dimension 
MaxWidth : Dimension 
MaxHeight : Dimension 
MaxLengthPlusGirth : Dimension 
MaxLWH : Dimension 
MinLength: Dimension 
MinWidth : Dimension 
MinHeight : Dimension 
MinThickness : Dimension 

Text : string 

AdditionalSizes : DimensionalRange[] 


ExtraPostageService Class 


Base Class 
None 


Properties 

ID : ExtraServicelD 

Name: string 

GroupCode : string 

Prices : PostagePrice[] 
AdditionalFields : Additionallnput[] 
Attributes: PostageAttribute[] 


ExtraPostageService.AdditionalInput Class 


Base Class 
None 


Properties 
Key : string 


Min : decimal 
Max: decimal 


ExtraServiceID Structure 


Base Class 
None 
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Properties 
Value : int 


GXGLocation Class 


Base Class 
None 


Properties 
LocationName : string 
Street : string 

City : string 

State: string 

ZipCode ZipCode : 
Weekda yCutOff : string 
SaturdayCutOff : string 


IDCard Class 


Base Class 
None 


Properties 

CallerlD : string 
SourcelD : string 
CustomerType : string 


Location Class 


Base Class 
None 


Properties 

ZipCode :ZipCode 

City :string 

State : string 

FinanceCode : string 

IsApo : bool 

ClassificationCode : string 
IsValid : bool 

IsMailable : bool 
IsHoldForPickupAvailable : bool 
IsSundayHolidayAvailable : bool 
NonDeliveryDays : DayOfWeek[] 
PremiumDays : DayOfWeek[] 
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LocationType : TypeOfLocation 
IsPOBox : bool 


TypeOfLocation Enumerator 
Origination 

Destination 

Neither 


MailingRestriction Class 


Base Class 
None 


Properties 
ZipCode : ZipCode 
Restrictions : Restriction[] 


MailingRestriction.Restriction Class 


Base Class 
None 


Properties 
Code : string 
Description : string 


MailServiceID Structure 


Base Class 
None 


Properties 
Value : short 


MailShapeAndSizeEnum Enumerator 
Unknown 

Letter 

LetterLarge 

Package 

Postcard 

FlatRateBox 

FlatRate 

ExpressMailServices 

PriorityMailServices 
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FirstClassMailServices 
PostalServices 
FlatRateEnvelope 


PostageAttribute 


Base Class 
None 


Properties 
Key : string 
Value : string 


PriceDetail Class 


Base Class 
None 


Properties 
Key : string 
Value : string 


PriceGroup Class 


Base Class 
None 


Properties 
Key : string 
Value : string 


PostagePrice Class 


Base Class 
None 


Properties 

Amount : decimal 
Type : string 

Details: PriceDetail[] 
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PostageService Class 


Base Class 
None 


Properties 

ID: MailServicelD 

Name: string 

DeliveryOptions : DeliveryOption[] 
GroupCode : string 

MaxWeight : Weight 

MinWeight : Weight 
DimensionalRange : DimensionalRange 
ExtraServices : ExtraPostageService[] 
Attributes: PostageAttribute[] 


PostageService.DeliveryOption Class 


Base Class 
None 


Properties 

Key : string 
Commitment : string 
Name: string 

Prices : PostagePrice[] 


ResultSection Class 


Base Class 
None 


Properties 
Key : ResultSection.SectionType 


ResultSection.SectionType Enumerator 
Unknown 

CountryRegulations 

DimensionalRange 

ExtraServices 

Geography 

GXGLocations 

PriceDetails 

Restrictions 

ServiceCommitments 
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Annotations 
Breadcrumb 
RelatedLinks 

HelpLinks 

Notes 

Footnotes 
ServiceCommitmentCall 


Weight Class 


Base Class 
None 


Properties 
Ounces : decimal 
Pounds : decimal 
Units : WeightUnit 


Weight.WeightUnit Enumerator 
Unknown 

Ounces 

Pounds 


ZipCode Structure 


Base Class 
None 


Properties 
Value : string 


Zone Class 


Base Class 
None 


Properties 

OriginZipCode : ZipCode 
DestinationZipCode : ZipCode 
ZoneCount : int 

IsIntraBMC: bool 

IsLocal : bool 

Has5DigitZones: bool 
Zone5DigitZones : Zone5Digit[] 
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Zone. Zone5Digit Class 


Base Class 
None 


Properties 
OrigZIPFirst : ZipCode 
OrigZIPLast : ZipCode 
DestZIPFirst : ZipCode 
DestZIPLast : ZipCode 
ZoneCount : int 
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Service Delivery Extensions 


DOMESTIC NAMESPACE 
OnlineServiceCommitment Class 


Base Class 
ServiceCommitment 


Properties 

EstimatedDeliveryTime : string 

DeliveryDateTime : DateTime 

IsHoliday : bool 

CommitmentName ; string 

CommitmentTime : string 

CommitmentSequence : string 

locations : ServiceCommitment.PostalLocation[] 
holdForPickupLocations : ServiceCommitment.PostalLocation[] 


ServiceCommitment Class 


Base Class 
None 


Properties 

ServiceCommitmentType : Type 

Product : string 

ErrorNumber : int 

ErrorMessage : string 
ServiceCommitmentGuarantee : Guarantee 
UsedByMailService : MailServicelD[] 


ServiceCommitment.Guarantee Enumerator 
Unknown 

NoGuarantee 

MoneyBackGuarantee 

LossOnlyGuarantee 


ServiceCommitment.Type Enumerator 
Unknown = 0 

ExpressMail 

PriorityMail 

FirstClassMail 

StandardMail 

Periodicals 
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PackageServices 


ServiceCommitment.PostalLocation Class 


Base Class 
None 


Properties 

CutOff : string 
Facility : string 
FacilitylD : string 
Street : string 

City : string 

State: string 
ZipCode : string 
ZipCode4 : string 
ScheduledDeliveryDate : DateTime 
closeTimes : string[] 


INTERNATIONAL NAMESPACE 


ExpressMailGuaranteed Class 


Base Class 
ServiceCommitment 


Properties 
None 


ServiceCommitment Class 


Base Class 
None 


Properties 

Type : ServiceCommitmentType 
ErrorNumber : int 

ErrorMessage: string 

DeliveryDate : string 

City : string 

StateOrProvince : string 
ShippingDate : DateTime 
ShippingTime : string 
UsedByMailService : MailServicelD[] 
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Appendix 


Customer Type Codes 
See “Client IDs and Customer Types. pdf” be complete details. 
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Group Code Description 


Mail Service Group Codes 
Index Field Name Code Description 


Service D [Domestic ^ | 
International 


Mail Type 
[P [ProyMal SSCS 
[B | Bound Printed Matter — ' | 


[R  jParelRetumServite — | 
[O  |PMOD «—  — —  — | 
[D |EDDM — — — — — — — — — — | 
GXG 

[Q — TSAR 
IPA 

None 


ee ee ee 
Extra Service (see Extra Service Group Code table) 

[None 
Flat Rate 


2 Sub Type 
|R  jRegonalRate U 
|B  |Nonauomation o ^ ^ ^ » | 
Q  [Automatonbsc — —  —  — o | 


[D| Carrier Route NonAutomation — — 
P Pesne — — — — — Š — — — 


3 | Shape 
[B [Bx — — — — Š SoooSo oyoo 


[P [ParelorPackage ^  — — ^ O | 
[4 — Shape Sub |0 |Shapesubversonütonumberof — | 
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Delivery Type 
Delivery Time 
[p [PM S SSS 


Extra Service Group Codes 
Index Field Name Code Description 

INN Service |D  jDomestic — ^. . —.  — 9  »— 
[I [International — — O 
1 [Type __{X_| Extra Service MÀ 
Extra Service Type 
[I | Insurance ——  — 0 O 
R  |RetmRecep — — Š Š | 
|D  j|CerificateofMailing — — — — | 
|J | Restricted Delivery —— — | 
|H — |SpecialHanding — — — — | 
[A | Adult Signature Required — — č — | 
[B | Adult Signature Restricted Delivery —  — | 
[M |1030Deivry ss . | 
|L — jParelAiift S O 
|Z — |Sunday/HolidayDelivery — — č | 
|K — | Picture PermitImprint —— i O 
[U | USPS Delivery Confirmation — č č | 
X Noe ^ 24^ | 
[E | Priority Mail Express —— — — | 
|P  jPrortyMal ———— ^ ^ | 
[c Jie = se CRM 
|0.. | Variation version O to number of — — č — | 
[x / [Noe — — ^ — O 


Associated Mail 
Type 


Sub Type 


4 | Variation _] 
6 | 
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Attribute Keys 


Domestic 
| Key | Description 


MailEntry The Mail Entrytype 


DimensionalWeightR The Dimensional Weight. Returned when the Dimensional Weight is used in 
HN the calculation of the Retail Price. 

DimensionalWeightCB The Dimensional Weight. Returned when the Dimensional Weight is used in 
pm the calculation of the Commercial Base Price. 

DimensionalWeightCP The Dimensional Weight. Returned when the Dimensional Weight is used in 
Kas samo sali the calculation of the Commercial Plus Price. 

DimensionalWeightNA The Dimensional Weight. Returned when the Dimensional Weight is used in 
mm the calculation of the Price and the Price Type is Not Applicable. 

International 
| Key Description 


Includedindemnity The included Insurance Indemnity for the mail service / weight. 
DeclaredValueSDR The value with the Special Drawing Right applied to the declare value. 


InclnceNonnegotiableDoc | The Included Insurance amount when the mail piece contains only 
Nonnegotiable Document(s). 


InclnceMerchandise The Included Insurance amount when the mail piece contains Merchandise. 


ECOMPRO Set to True or False to indicate that Priority Mail International mail service is 
or is not ECOMPRO. 

Ip. type Indicator if the block information is for a Logistics Partneror Post. 
See the Web Service UPUXIT SDC Spec 

The Logistics Partner code that will support international transportation. 

Ip. barcodetype The barcode(s) that a Logistics Partner will support for international 
transportation. A commas delimited list of Barcodes. 
i.e. S10,W12 


USPS Pricing Engine Web Services version 11.10.2.0 Page 37 of 39 





Content Keys 


Domestic 
| Key Description 
LiveAnimals The mail piece content is a Live Animal(s). 
Equivalent to Special Handling - Live Animal Transportation 


Equivalent to Special Handling - Hazardous Material Transportation 


The mail piece content is Cremated Remains 
Perishables The mail piece content is Perishable. 

Fragile The mail piece content is Fragile 

[UMP [fmiabtomeca adn tage U 


MedicalSupplies The mail piece contains medical supplies 
Pharmaceuticals The mail piece contains pharmaceutical supplies 


Note: Content Keys are subject to change. 


International 
Description 


Key 


Note: Content Keys are subject to change. 


Price Detail Keys 


Domestic 


| Description 
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International 


| Description 


Nonmachinable Fee 


Price Group Keys 


International 


| Description 


The Price Group Keys matches the SKU definition for Price Types. 


Sortation Keys 


Domestic 


| Key | Description 


Any mixed mailing 
Note: Sortation Keys will be extended as new sortation's are supported 


U 


I O 


a] 
oio 
m| mn 


li 
U 
TI 


al a 
Z3 
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